home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3dm / audio / alNextEvent.z / alNextEvent
Encoding:
Text File  |  1998-10-20  |  4.1 KB  |  67 lines
  1.  
  2.  
  3.  
  4. aaaallllNNNNeeeexxxxttttEEEEvvvveeeennnntttt((((3333ddddmmmm))))                                              aaaallllNNNNeeeexxxxttttEEEEvvvveeeennnntttt((((3333ddddmmmm))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      alNextEvent - Retrieves front most event from queue
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<ddddmmmmeeeeddddiiiiaaaa////aaaauuuuddddiiiioooo....hhhh>>>>
  13.  
  14.      iiiinnnntttt aaaallllNNNNeeeexxxxttttEEEEvvvveeeennnntttt((((AAAALLLLeeeevvvveeeennnnttttQQQQuuuueeeeuuuueeee eeeevvvveeeennnnttttqqqq,,,, AAAALLLLeeeevvvveeeennnntttt eeeevvvveeeennnntttt))))
  15.  
  16. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRR
  17.      _e_v_e_n_t_q   expects a valid AAAALLLLeeeevvvveeeennnnttttQQQQuuuueeeeuuuueeee structure from which you want to
  18.               retrieve audio events.
  19.  
  20.      _e_v_e_n_t    expects an AAAALLLLeeeevvvveeeennnntttt structure previously initialized by
  21.               aaaallllNNNNeeeewwwwEEEEvvvveeeennnntttt((((3333ddddmmmm)))).
  22.  
  23.  
  24. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  25.      aaaallllNNNNeeeexxxxttttEEEEvvvveeeennnntttt((((3333ddddmmmm)))) retrieves the next AAAALLLLeeeevvvveeeennnntttt in _e_v_e_n_t_q and places it in
  26.      _e_v_e_n_t.  If _e_v_e_n_t_q is empty, the call will block until an AAAALLLLeeeevvvveeeennnntttt is
  27.      received by _e_v_e_n_t_q.
  28.  
  29.      To process the event, use the following calls: aaaallllGGGGeeeettttEEEEvvvveeeennnnttttPPPPaaaarrrraaaammmm((((3333ddddmmmm)))),
  30.      aaaallllGGGGeeeettttEEEEvvvveeeennnnttttUUUUSSSSTTTT((((3333ddddmmmm)))), aaaallllGGGGeeeettttEEEEvvvveeeennnnttttVVVVaaaalllluuuueeee((((3333ddddmmmm)))), aaaallllGGGGeeeettttEEEEvvvveeeennnnttttDDDDaaaattttaaaa((((3333ddddmmmm)))),
  31.      aaaallllGGGGeeeettttEEEEvvvveeeennnnttttRRRReeeessssoooouuuurrrrcccceeee((((3333ddddmmmm)))),  and aaaallllGGGGeeeettttEEEEvvvveeeennnnttttSSSSrrrrccccRRRReeeessssoooouuuurrrrcccceeee((((3333ddddmmmm)))).
  32.  
  33. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  34.      Upon successful completion, aaaallllNNNNeeeexxxxttttEEEEvvvveeeennnntttt returns 0. Otherwise, aaaallllNNNNeeeexxxxttttEEEEvvvveeeennnntttt
  35.      returns -1 and sets an error number which can be retrieved with
  36.      oooosssseeeerrrrrrrroooorrrr((((3333CCCC)))).
  37.  
  38.      aaaallllNNNNeeeexxxxttttEEEEvvvveeeennnntttt can fail for the following reason:
  39.  
  40.      AAAALLLL____BBBBAAAADDDD____IIIINNNNVVVVAAAALLLLIIIIDDDD____EEEEVVVVEEEENNNNTTTTQQQQ   _e_v_e_n_t_q is either invalid or null.
  41.  
  42.      AAAALLLL____BBBBAAAADDDD____IIIINNNNVVVVAAAALLLLIIIIDDDD____EEEEVVVVEEEENNNNTTTT    _e_v_e_n_t is either invalid or null.
  43.  
  44. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  45.      alOpenEventQueue(3dm), alGetEventParam(2), alGetEventUST(2),
  46.      alGetEventValue(3dm), alGetEventData(3dm), alGetEventResource(3dm),
  47.      alGetEventSrcResource(3dm), oserror(3C)
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.